home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / os2 / gnucal.zip / gcal-us.info-2 (.txt) < prev    next >
GNU Info File  |  1995-12-20  |  48KB  |  1,019 lines
  1. This is Info file ./gcal-us.info, produced by Makeinfo-1.63 from the
  2. input file ./doc/tex/gcal-us.texi.
  3.   This file documents Gcal, a program for printing calendars.  It
  4. displays a calendar for a month or for a year, eternal holiday lists
  5. and fixed date warning lists; in many ways.  Gcal correctly omits the
  6. dates that were skipped when the current Gregorian calendar replaced
  7. the earlier Julian calendar.
  8.   Copyright (C) 1994, 1995 Thomas Esken
  9.   This is the first edition of the Gcal documentation.
  10.   Permission is granted to make and distribute verbatim copies of this
  11. manual provided the copyright notice and this permission notice are
  12. preserved on all copies.
  13.   Permission is granted to copy and distribute modified versions of this
  14. manual under the conditions for verbatim copying, provided that the
  15. entire resulting derived work is distributed under the terms of a
  16. permission notice identical to this one.
  17.   Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions, except that this permission notice may be stated in a
  20. translation approved by the Foundation.
  21.   Any suggestions, improvements, extensions, bug reports, donations,
  22. proposals for contract work, and so forth are welcome!  Please send
  23. them directly to my Email address.  If you like my work, I'd appreciate
  24. a postcard from you!
  25.                                 \\\_''/'
  26. -------------------------oOO    (/o-o\)    OOo-------------------------
  27. Thomas Esken                o  (.  "  .)  o   Internet :
  28. Im Hagenfeld 84              \___) ~ (___/      <esken@uni-muenster.de>
  29. D-48147 M"unster; GERMANY                     Phone : (+49) 0251 232585
  30. File: gcal-us.info,  Node: Date warning options,  Prev: Calendar options,  Up: Options
  31. Date warning options
  32. ....................
  33. `-v DEFINITION'
  34. `--date-variable=ARG'
  35. `--assign=ARG'
  36.      Define "global" date variable, which is visible in all referenced
  37.      resource files (*note Date variables::.).  DEFINITION must either
  38.      be a valid single date variable definition or a (`:')
  39.      colon-separated list of definitions.
  40.      A date variable name DVAR consists of a single alphabetic character
  41.      (except the `e' character, which is internally reserved for Easter
  42.      Sunday's date and which is unassignable/unoperatable) followed by
  43.      the assignment operator character `=' and the numerical values of
  44.      month MM (or a short, three characters month name, e.g. `Jan',
  45.      `Feb'...) and day DD this variable has to store (or another global
  46.      date variable name, but *no* date given in the `MMWWWN' or the
  47.      `*d|wN[WWW]' format).
  48.      Some examples:
  49.           `--date-variable=a=1127' respectively
  50.           `--assign=a=1127' respectively
  51.           `-v a=1127'
  52.           stores the 27'th November to global date variable A.
  53.           `--date-variable=a=Nov27:b=054:c=a' respectively
  54.           `--assign=a=Nov27:b=054:c=a' respectively
  55.           `-v a=Nov27:b=054:c=a'
  56.           stores the 27'th November to global date variable A, the 4'th
  57.           May to the global date variable B and the value of global
  58.           date variable A to C.
  59. `-c|C[-]'
  60. `--list-of-fixed-dates[=short|long]'
  61. `--descending-fixed-dates[=short|long]'
  62.      Display fixed date warning messages.
  63.     `-c'
  64.     `--list-of-fixed-dates=short'
  65.           *Use standard resource file* (activate fixed date warning
  66.           function) and list all dates related to current day sorted in
  67.           ascending order.  If no fixed dates related to the current
  68.           day are found, no fixed date warning messages are displayed
  69.           and the program is terminated with error code, see *Note 1:
  70.           Error codes.
  71.     `-c-'
  72.     `--descending-fixed-dates=short'
  73.           *Use standard resource file* (activate fixed date warning
  74.           function) and list all dates related to current day sorted in
  75.           descending order.  If no fixed dates related to the current
  76.           day are found, no fixed date warning messages are displayed
  77.           and the program is terminated with error code, see *Note 1:
  78.           Error codes.
  79.     `-C'
  80.     `--list-of-fixed-dates=long'
  81.           *Use standard resource file* (activate fixed date warning
  82.           function) and list all dates related to current day sorted in
  83.           ascending order.  If no fixed dates related to the current
  84.           day are found, a fixed date warning text which consists of
  85.           the *date part* only is displayed.
  86.     `-C-'
  87.     `--descending-fixed-dates=long'
  88.           *Use standard resource file* (activate fixed date warning
  89.           function) and list all dates related to current day sorted in
  90.           descending order.  If no fixed dates related to the current
  91.           day are found, a fixed date warning text which consists of
  92.           the *date part* only is displayed.
  93. `-f|F NAME[+...]'
  94. `--resource-file=ARG'
  95.      Use file NAME instead of the standard resource file.  You can use
  96.      more than one resource file NAME by separating them with a `+'
  97.      separator character, e.g.:
  98.           `--resource-file=./foo+xyz+/lib/foo.bar+$HOME/.gcalrc' resp.,
  99.           `-f ./foo+xyz+/lib/foo.bar+$HOME/.gcalrc'
  100.      respects all files, which are given in above list.  This argument
  101.      implies the simple `-c' respectively `--list-of-fixed-dates=short'
  102.      option *only* (*note `--list-of-fixed-dates[=short|long]': Date
  103.      warning options.).  Set NAME to `/dev/null' to avoid the use of
  104.      the standard resource file, usefull for creating empty fixed dates
  105.      warning lists.
  106. *Please note:*
  107. If the short-style option `-c' and/or its modifiers `t|[w|m|y]'
  108. respectively the short-style option `-f' is/are given in *upper case*,
  109. e.g.:
  110.      -C
  111.      -F foo.bar
  112.      -CeT
  113.      -c-aW+
  114.      -CeaxY-
  115.      -c-M
  116. Gcal displays fixed date messages for *each* day of the requested
  117. period.
  118.   The modifiers of a combined/complex/packed short-style fixed date
  119. warning option must be constructed according to following steps,
  120. because Gcal treats them as positional parameters:
  121.     First step: *Sorting-Order-Of-Text-Modifier*
  122.           `-'
  123.     Second step: *Representation-Of-Text-Modifier*
  124.           `a', `e|E', `k', `o', `x', `z'
  125.     Third step: *Respected-Warning-Period-Modifier*
  126.           `d', `l', `c|C', `t|T', `w|W|m|M|y|Y[+|-]', `N+|-', `Nd',
  127.           `Nw', `*dN[WWW]', `*wN[WWW]', `@e|DVAR[[+|-]N]',
  128.           `@e|DVAR[+|-]NWWW', `MMDD', `MMWWWN'
  129.   If you want to operate with the following modifiers, an *explicit*
  130. `-c|C[-]' short-style option must be leading, e.g.:
  131.      -c-t
  132.      -cw-
  133.      -Cadekoluxz12+
  134. and only *one* period defining fixed date warning period modifier may
  135. be given (this means exclusive the `--include-today' option
  136. respectively `d' modifier, and `--list-mode' option respectively `l'
  137. modifier).
  138. *Fixed date warning text modifiers:*
  139. `--include-resource-file-name'
  140.      Extend fixed date warning text by the name of the resource file,
  141.      which the warning text comes from, e.g.:
  142.           WWW, MM DD YYYY (RESOURCE FILE NAME) TEXT.
  143. `--include-holidays=long'
  144.      Enable inclusion of all eternal holiday dates, this includes
  145.      memorial days and legal days.
  146. `--include-holidays=short'
  147.      Enable inclusion of those eternal holiday dates, which are legal
  148.      days only.
  149. `g[TEXT]'
  150. `--grouping-text[=ARG]'
  151.      Group fixed date warnings by day using separator TEXT.  If TEXT is
  152.      not given, the built-in text TEXT (`RC_GROUP_SEP' "" == empty line
  153.      only) is used for grouping, e.g.:
  154.           % gcal -Cw -cg
  155.           
  156.            Su, Nov 06'th 1994: text1
  157.            Su, Nov 06'th 1994: text2
  158.           
  159.            Mo, Nov 07'th 1994: text3
  160.           
  161.            Tu, Nov 08'th 1994: text4
  162.            ...
  163.           
  164.           
  165.           % gcal -Cw -cg---a_user_defined_grouping_text
  166.           
  167.            Su, Nov 06'th 1994: text1
  168.            Su, Nov 06'th 1994: text2
  169.            ---a_user_defined_grouping_text
  170.            Mo, Nov 07'th 1994: text3
  171.            ---a_user_defined_grouping_text
  172.            Tu, Nov 08'th 1994: text4
  173.            ...
  174.      Each time a `~' (tilde) character is found in TEXT, this character
  175.      is replaced by a real `\n' (newline) character.
  176.      You may quote the `~' (tilde) character - in case this character
  177.      itself is needed - by placing a `\' (backslash) character before
  178.      it, e.g. `\~'.
  179.      If you need the characters `\~' itself, you have to quote the `\'
  180.      (backslash) character by itself, e.g. `\\~'.
  181. `--include-weeknumber'
  182.      Extend the *date part* of a warning message by the ISO-8601:1988
  183.      week number of that date.
  184.      *Please note:*
  185.      The methods of ISO-8601:1988 are used for detecting week numbers;
  186.      this means a week begins with a Monday, and the first week of a
  187.      year is the one which includes the first Thursday; equivalently,
  188.      the one which includes 4'th January.
  189. `--omit-multiple-date-part'
  190.      Omit the *date part* of a warning message in case more than one
  191.      warning message refers to that date.
  192. `--exclude-fixed-dates-list-title'
  193.      Suppresses the title text line of the fixed date warning list.
  194. `--include-consecutive-number'
  195.      Display consecutive numbers of fixed date warning messages.
  196. *Fixed date warning period modifiers:*
  197. `--include-today'
  198.      If lists of periods are generated, include the actual date into
  199.      the list.  *Note --list-mode: Date warning options, for how to
  200.      create a list of periods.
  201. `--list-mode'
  202.      Generate a list of periods instead of a single period.
  203.      *Please note:*
  204.      The following examples assume the current date is the 17'th
  205.      February of any year.
  206. `--period-of-fixed-dates=ARG'
  207. `*dN'
  208.      Single date of absolute day N == `1...365|366|999' of actual year;
  209.      the warning level is same as simple `-c' option.  If the value 999
  210.      for N is given, the last day of the year (31'st December) is
  211.      assumed.
  212.         * E.g. `gcal -c10d' respectively
  213.           `gcal --period-of-fixed-dates=10d' or `gcal -c*d10'
  214.           respectively `gcal --period-of-fixed-dates=*d10' displays all
  215.           fixed dates, which occur on the 10'th day of the year.
  216. `lNd'
  217. `l*dN'
  218.      List dates starting yesterday or tomorrow (depending on given day
  219.      number N) and ending at N'th absolute day of actual year; the
  220.      warning level is same as `-cy' option.
  221.         * E.g. `gcal -cl10d' respectively `gcal -cl*d10' displays a
  222.           list of all fixed dates, which start on the 10'th day of year
  223.           and end on 16'th February.
  224. `N+|-'
  225.      Single date of day *actual day `+/-' N days* of actual year; the
  226.      warning level is same as simple `-c' option.
  227.         * E.g. `gcal -c10+' displays all fixed dates, which occur 10
  228.           days after the 17'th February (today).
  229.         * E.g. `gcal -c10-' displays all fixed dates, which occur 10
  230.           days before the 17'th February (today).
  231. `lN+|-'
  232.      List dates starting yesterday `-' or tomorrow `+' and ending at
  233.      *actual day `+/-' N days* of actual year; the warning level is
  234.      same as `-cy' option.
  235.         * E.g. `gcal -cl10+' displays a list of all fixed dates, which
  236.           start on the 18'th February and end 10 days after.
  237.         * E.g. `gcal -cl10-' displays a list of all fixed dates, which
  238.           start 10 days before the 16'th February and end on the 16'th
  239.           February.
  240.      Single dates of week number N == `0|1...52|53|99' of actual year;
  241.      the warning level is same as `-cw' option.
  242.         * E.g. `gcal -c0w' displays all fixed dates, which occur in the
  243.           53'rd week of previous year, in case the previous year has a
  244.           53'rd week.  If the previous year has 52 weeks only, all
  245.           fixed dates occuring on the 1'st week of the actual year are
  246.           displayed.
  247.         * E.g. `gcal -c6w' displays all fixed dates, which occur in the
  248.           6'th week of year.
  249.         * E.g. `gcal -c52w' displays all fixed dates, which occur in
  250.           the 52'nd week of year.
  251.         * E.g. `gcal -c53w' displays all fixed dates, which occur in
  252.           the 53'rd week of the actual year, in case the actual year
  253.           has a 53'rd week.  If the actual year has 52 weeks only, no
  254.           fixed date warning messages are displayed and the program is
  255.           terminated with error code, see *Note 126: Error codes.
  256.         * E.g. `gcal -c99w' displays all fixed dates, which occur in
  257.           the last week of the actual year, i.e. either the 52'nd or
  258.           the 53'rd week.
  259. `lNw'
  260.      List dates starting yesterday or tomorrow (depending on given week
  261.      number N) and ending at first respectively last day of given week
  262.      number N == `0|1...52|53|99' of actual year; the warning level is
  263.      same as `-cy' option.
  264.         * E.g. `gcal -cl12w' displays a list of all fixed dates, which
  265.           start on the 18'th February and end on the last day of the
  266.           12'th week.
  267.         * E.g. `gcal -cl3w' displays a list of all fixed dates, which
  268.           start on the first day of the 3'rd week and end on the 16'th
  269.           February.
  270. `MMDD'
  271.      Single date of day DD in month MM of actual year; the warning
  272.      level is same as simple `-c' option.
  273.         * E.g. `gcal -c0225' displays all fixed dates, which occur on
  274.           the 25'th February.
  275. `lMMDD'
  276.      List dates starting yesterday or tomorrow (depending on the value
  277.      given in MMDD) and ending at day DD of month MM of actual year;
  278.      the warning level is same as `-cy' option.
  279.         * E.g. `gcal -cl0225' displays a list of all fixed dates, which
  280.           start on the 18'th February and end on the 25'th February.
  281.         * E.g. `gcal -cl0109' displays a list of all fixed dates, which
  282.           start on the 09'th January and end on the 16'th February.
  283. `MMWWWN'
  284.      Single date of N'th == `1...5|9' weekday DD|WWW in month MM of
  285.      actual year; the warning level is same as simple `-c' option.
  286.         * E.g. `gcal -c01mon3' displays all fixed dates, which occur on
  287.           the 3'rd Monday in January.
  288.         * E.g. `gcal -c02fri9' displays all fixed dates, which occur on
  289.           the last Friday in February.
  290. `lMMWWWN'
  291.      List dates starting yesterday or tomorrow (depending on the value
  292.      given in MMWWWN) and ending at N'th == `1...5|9' weekday DD of
  293.      month MM of actual year; the warning level is same as `-cy' option.
  294.         * E.g. `gcal -cl01mon3' displays a list of all fixed dates,
  295.           which start on the 3'rd Monday in January and end on the
  296.           16'th February.
  297.         * E.g. `gcal -cl02fri9' displays a list of all fixed dates,
  298.           which start on the 18'th February and end on the last Friday
  299.           in February.
  300. `*dNWWW'
  301.      Single date of N'th == `1...51|52|53|99' weekday WWW of actual
  302.      year; the warning level is same as simple `-c' option.
  303.         * E.g. `gcal -c*d16sun' displays all fixed dates, which occur
  304.           on the 16'th Sunday of actual year.
  305.         * E.g. `gcal -c*d52sun' displays all fixed dates, which occur
  306.           on the 52'nd Sunday of actual year.  If the actual year has
  307.           no 52'nd Sunday, no fixed date warning messages are displayed
  308.           and the program is terminated with error code, see *Note 126:
  309.           Error codes.
  310.         * E.g. `gcal -c*d53sun' displays all fixed dates, which occur
  311.           on the 53'rd Sunday of actual year.  If the actual year has
  312.           no 53'rd Sunday, no fixed date warning messages are displayed
  313.           and the program is terminated with error code, see *Note 126:
  314.           Error codes.
  315.         * E.g. `gcal -c*d99sun' displays all fixed dates, which occur
  316.           on the last Sunday (that's either the 51'st, 52'nd or 53'rd
  317.           Sunday) of actual year.
  318. `l*dNWWW'
  319.      List dates starting yesterday or tomorrow (depending on the value
  320.      given in N) and ending at N'th == `1...51|52|53|99' weekday WWW of
  321.      actual year; the warning level is same as `-cy' option.
  322.         * E.g. `gcal -cl*d16sun' displays a list of all fixed dates,
  323.           which start on the 18'th February and end on the 16'th Sunday
  324.           of actual year.
  325.         * E.g. `gcal -cl*d52sun' displays a list of all fixed dates,
  326.           which start on the 18'th February and end on the 52'nd Sunday
  327.           of actual year.  If the actual year has no 52'nd Sunday, no
  328.           fixed date warning messages are displayed and the program is
  329.           terminated with error code, see *Note 126: Error codes.
  330.         * E.g. `gcal -cl*d53sun' displays a list of all fixed dates,
  331.           which start on the 18'th February and end on the 53'nd Sunday
  332.           of actual year.  If the actual year has no 53'nd Sunday, no
  333.           fixed date warning messages are displayed and the program is
  334.           terminated with error code, see *Note 126: Error codes.
  335.         * E.g. `gcal -cl*d99sun' displays a list of all fixed dates,
  336.           which start on the 18'th February and end on the last Sunday
  337.           (that's either the 51'st, 52'nd or 53'rd Sunday) of actual
  338.           year.
  339. `*wN[WWW]'
  340.      Single date of weekday WWW of N'th == `0|1...52|53|99' week of
  341.      actual year; the warning level is same as simple `-c' option.  If
  342.      no weekday WWW is given, then Monday is assumed for the weekday.
  343.         * E.g. `gcal -c*w0sun' displays all fixed dates, which occur on
  344.           Sunday, which is located in the 52'nd respectively 53'rd week
  345.           of previous year.  In case such a Sunday doesn't exist, no
  346.           fixed date warning messages are displayed an the program is
  347.           terminated with error code, see *Note 126: Error codes.
  348.         * E.g. `gcal -c*w16sun' displays all fixed dates, which occur on
  349.           Sunday of the 16'th week of actual year.
  350.         * E.g. `gcal -c*w52sun' displays all fixed dates, which occur on
  351.           Sunday of the 52'nd week of actual year.  If the actual year
  352.           has no Sunday of the 52'nd week, no fixed date warning
  353.           messages are displayed and the program is terminated with
  354.           error code, see *Note 126: Error codes.
  355.         * E.g. `gcal -c*w53sun' displays all fixed dates, which occur on
  356.           Sunday of the 53'rd week of actual year.  If the actual year
  357.           has no Sunday of the 53'rd week, no fixed date warning
  358.           messages are displayed and the program is terminated with
  359.           error code, see *Note 126: Error codes.
  360.         * E.g. `gcal -c*w99sun' displays all fixed dates, which occur on
  361.           Sunday of the last week (that's either the 52'nd or 53'rd
  362.           week) of actual year.
  363. `l*wN[WWW]'
  364.      List dates starting yesterday or tomorrow (depending on the value
  365.      given in N) and ending at weekday WWW of N'th == `0|1...52|53|99'
  366.      week of actual year; the warning level is same as `-cy' option.
  367.      If no weekday WWW is given, then Monday is assumed for the weekday.
  368.         * E.g. `gcal -cl*w0sun' displays a list of all fixed dates,
  369.           which start on Sunday, which is located in the 52'nd
  370.           respectively 53'rd week of previous year and end on 16'th
  371.           February.  In case such a Sunday doesn't exist, no fixed date
  372.           warning messages are displayed an the program is terminated
  373.           with error code, see *Note 126: Error codes.
  374.         * E.g. `gcal -cl*w16sun' displays a list of all fixed dates,
  375.           which start on the 18'th February and end on Sunday of the
  376.           16'th week of actual year.
  377.         * E.g. `gcal -cl*w52sun' displays a list of all fixed dates,
  378.           which start on the 18'th February and end on Sunday of the
  379.           52'nd week of actual year.  If the actual year has no Sunday
  380.           of the 52'nd week, no fixed date warning messages are
  381.           displayed and the program is terminated with error code, see
  382.           *Note 126: Error codes.
  383.         * E.g. `gcal -cl*w53sun' displays a list of all fixed dates,
  384.           which start on the 18'th February and end on Sunday of the
  385.           53'rd week of actual year.  If the actual year has no Sunday
  386.           of the 53'rd week, no fixed date warning messages are
  387.           displayed and the program is terminated with error code, see
  388.           *Note 126: Error codes.
  389.         * E.g. `gcal -cl*w99sun' displays a list of all fixed dates,
  390.           which start on the 18'th February and end on Sunday of the
  391.           last week (that's either the 52'nd or 53'rd week) of actual
  392.           year.
  393. `@e[[+|-]N]'
  394.      Single date of day N relative to Easter Sunday's date of actual
  395.      year; the warning level is same as simple `-c' option.
  396.         * E.g. `gcal -c@e' displays all fixed dates, which occur on the
  397.           Easter Sunday's date.
  398.         * E.g. `gcal -c@e10' respectively `gcal -c@e+10' displays all
  399.           fixed dates, which occur 10 days after the Easter Sunday's
  400.           date.
  401.         * E.g. `gcal -c@e-10' displays all fixed dates, which occur 10
  402.           days before the Easter Sunday's date.
  403. `l@e[[+|-]N]'
  404.      List dates starting yesterday or tomorrow (depending on the value
  405.      given in N) and ending at N'th day relative to Easter Sunday's
  406.      date of actual year; the warning level is same as `-cy' option.
  407.         * E.g. `gcal -cl@e' displays a list of all fixed dates, which
  408.           start on the 18'th February and end on the Easter Sunday's
  409.           date.
  410.         * E.g. `gcal -cl@e10' respectively `gcal -cl@e+10' displays a
  411.           list of all fixed dates, which start on the 18'th February
  412.           and end 10 days after the Easter Sunday's date.
  413.         * E.g. `gcal -cl@e-10' displays a list of all fixed dates,
  414.           which start on the 18'th February and end 10 days before the
  415.           Easter Sunday's date.
  416. `@e[+|-]NWWW'
  417.      Single date of N'th weekday WWW relative to Easter Sunday's date
  418.      of actual year; the warning level is same as simple `-c' option.
  419.         * E.g. `gcal -c@e3fri' respectively `gcal -c@e+3fri' displays
  420.           all fixed dates, which occur on the 3'rd Friday after the
  421.           Easter Sunday's date.
  422.         * E.g. `gcal -c@e-3fri' displays all fixed dates, which occur
  423.           on the 3'rd Friday before the Easter Sunday's date.
  424. `l@e[+|-]NWWW'
  425.      List dates starting yesterday or tomorrow (depending on the value
  426.      given in N) and ending at N'th weekday WWW relative to Easter
  427.      Sunday's date of actual year; the warning level is same as `-cy'
  428.      option.
  429.         * E.g. `gcal -cl@e3fri' respectively `gcal -cl@e+3fri' displays
  430.           a list of all fixed dates, which start on the 18'th February
  431.           and end on the 3'rd Friday after the Easter Sunday's date.
  432.         * E.g. `gcal -cl@e-3fri' displays a list of all fixed dates,
  433.           which start on the 18'th February and end on the 3'rd Friday
  434.           before the Easter Sunday's date.
  435. `@DVAR[[+|-]N]'
  436.      Single date of day N relative to date variables date of actual
  437.      year; the warning level is same as simple `-c' option.
  438.         * E.g. `gcal -v a=0422 -c@a' displays all fixed dates, which
  439.           occur on the 22'nd April.
  440.         * E.g. `gcal -v a=0422 -c@a10' respectively `gcal -v a=0422
  441.           -c@a+10' displays all fixed dates, which occur 10 days after
  442.           the 22'nd April.
  443.         * E.g. `gcal -v a=0422 -c@a-10' displays all fixed dates, which
  444.           occur 10 days before the 22'nd April.
  445. `l@DVAR[[+|-]N]'
  446.      List dates starting yesterday or tomorrow (depending on the value
  447.      given in N) and ending at N'th day relative to date variables date
  448.      of actual year; the warning level is same as `-cy' option.
  449.         * E.g. `gcal -v a=0422 -cl@a' displays a list of all fixed
  450.           dates, which start on the 18'th February and end on the 22'nd
  451.           April.
  452.         * E.g. `gcal -v a=0422 -cl@a10' respectively `gcal -v a=0422
  453.           -cl@a+10' displays a list of all fixed dates, which start on
  454.           the 18'th February and end 10 days after the 22'nd April.
  455.         * E.g. `gcal -v a=0422 -cl@a-10' displays a list of all fixed
  456.           dates, which start on the 18'th February and end 10 days
  457.           before the 22'nd April.
  458. `@DVAR[+|-]NWWW'
  459.      Singe date of N'th weekday WWW relative to date variables date of
  460.      actual year; the warning level is same as simple `-c' option.
  461.         * E.g. `gcal -v a=0122 -c@a2sat' respectively `gcal -v a=0122
  462.           -c@a+2sat' displays all fixed dates, which occur on the 2'nd
  463.           Saturday after the 22'nd January.
  464.         * E.g. `gcal -v a=0122 -c@a-2sat' displays all fixed dates,
  465.           which occur on the 2'nd Saturday before the 22'nd January.
  466. `l@DVAR[+|-]NWWW'
  467.      List dates starting yesterday or tomorrow (depending on the value
  468.      given in N) and ending at N'th weekday WWW relative to date
  469.      variables date of actual year; the warning level is same as `-cy'
  470.      option.
  471.         * E.g. `gcal -v a=0122 -cl@a2sat' respectively `gcal -v a=0122
  472.           -cl@a+2sat' displays a list of all fixed dates, which start
  473.           on the 2'nd Saturday after the 22'nd January and end on the
  474.           16'th February.
  475.         * E.g. `gcal -v a=0122 -cl@a-2sat' displays a list of all fixed
  476.           dates, which start on the 2'nd Saturday before the 22'nd
  477.           January and end on the 16'th February.
  478. `t|T'
  479.      List dates related to tomorrow.
  480.         * E.g. `gcal -ct' displays all fixed dates, which occur on the
  481.           18'th February (tomorrow).
  482.         * E.g. `gcal -cdt' displays all fixed dates, which occur on the
  483.           17'th February (today) and on the 18'th February (tomorrow).
  484. `w|W[+|-]'
  485.      Display week warnings (*note `--starting-day[=ARG]': Calendar
  486.      options.).
  487.         * `w'
  488.           List dates between *starting day* of current week and last
  489.           day of current week
  490.              - E.g. `gcal -cw' displays all fixed dates, which occur in
  491.                the whole week the 17'th February is part of.
  492.         * `w+'
  493.           List dates between day after current day of current week and
  494.           last day of current week.
  495.              - E.g. `gcal -cw+' displays all fixed dates, which start
  496.                on the 18'th February (tomorrow) and end on the last day
  497.                of the week.
  498.              - E.g. `gcal -cdw+' displays all fixed dates, which start
  499.                on the 17'th February (today) and end on the last day of
  500.                the week.
  501.         * `w-'
  502.           List dates between *starting day* of current week and day
  503.           before current day of current week
  504.              - E.g. `gcal -cw-' displays all fixed dates, which start
  505.                on the first day of the week and end on the 16'th
  506.                February (yesterday).
  507.              - E.g. `gcal -cdw-' displays all fixed dates, which start
  508.                on the first day of the week and end on the 17'th
  509.                February (today).
  510. `m|M[+|-]'
  511.      Display month warnings.
  512.         * `m'
  513.           List dates between first day of current month and last day of
  514.           current month.
  515.              - E.g. `gcal -cm' displays all fixed dates, which occur in
  516.                the whole month February.
  517.         * `m+'
  518.           List dates between day after current day of current month and
  519.           last day of current month.
  520.              - E.g. `gcal -cm+' displays all fixed dates, which start
  521.                on the 18'th February (tomorrow) and end on the last day
  522.                of the month February.
  523.              - E.g. `gcal -cdm+' displays all fixed dates, which start
  524.                on the 17'th February (today) and end on the last day of
  525.                the month February.
  526.         * `m-'
  527.           List dates between first day of current month and day before
  528.           current day of current month.
  529.              - E.g. `gcal -cm-' displays all fixed dates, which start
  530.                on the first day of the month February and end on the
  531.                16'th February (yesterday).
  532.              - E.g. `gcal -cdm-' displays all fixed dates, which start
  533.                on the first day of the month February and end on the
  534.                17'th February (today).
  535. `y|Y[+|-]'
  536.      Display year warnings.
  537.         * `y'
  538.           List dates between first day of current year and last day of
  539.           current year.
  540.              - E.g. `gcal -cy' displays all fixed dates, which occur in
  541.                the whole year.
  542.         * `y+'
  543.           List dates between day after current day of current year and
  544.           last day of current year.
  545.              - E.g. `gcal -cy+' displays all fixed dates, which start
  546.                on the 18'th February (tomorrow) and end on the last day
  547.                of the year.
  548.              - E.g. `gcal -cdy+' displays all fixed dates, which start
  549.                on the 17'th February (today) and end on the last day of
  550.                the year.
  551.         * `y-'
  552.           List dates between first day of current year and day before
  553.           current day of current year.
  554.              - E.g. `gcal -cy-' displays all fixed dates, which start
  555.                on the first day of the year and end on the 16'th
  556.                February (yesterday).
  557.              - E.g. `gcal -cdy-' displays all fixed dates, which start
  558.                on the first day of the year and end on the 17'th
  559.                February (today).
  560. File: gcal-us.info,  Node: Response file,  Next: Actual date modifier,  Prev: Options,  Up: Command line arguments
  561. Response file
  562. -------------
  563.   If a `@FILE' option is given in command line, a "response file" FILE
  564. will be used, i.e. options and commands are preloaded from that file.
  565. A response file FILE may contain options and commands, which are
  566. preloaded by Gcal, but *no* reference to further response files (*note
  567. `--log-file=ARG': Global options.).
  568.   The searching scheme for a response file is the same as that for
  569. resource files, except *no* standard response file is respected.  *Note
  570. File searching mechanism: Resource file, for more details.  Multiple
  571. response files may be given in the command line when Gcal is started
  572. and are processed exactly in that order as given, i.e. strictly
  573. sequential.
  574.   Each option and command must be on a single line, i.e. separated by a
  575. real `\n' (newline) character.  A line beginning with a `;' (semicolon)
  576. character in the response file is treated as a remark and will not be
  577. used by Gcal (*note Comment line: Resource file.).
  578.   Options must be defined before commands.  If a response file contains
  579. any commands, then all further arguments after the `@FILE' option of
  580. the command line are ignored.
  581. For example:
  582.   1. Contents of response file `file':
  583.           Line     Text
  584.           1        -j
  585.           2        -Cw
  586.           <EOF>
  587.           
  588.           % gcal -i -b 3 @file -s 3 1994
  589.           
  590.           ==> gcal -i -b 3 -j -Cw -s 3 1994
  591.   2. Contents of response file `file':
  592.           Line     Text
  593.           1        -j
  594.           2        -Cw
  595.           3        may 1992
  596.           <EOF>
  597.           
  598.           % gcal -i -b 3 @file -s 3 1994
  599.           
  600.           ==> gcal -i -b 3 -j -Cw may
  601.   3. Contents of response file `file':
  602.           Line     Text
  603.           1        -j
  604.           2        -Cw
  605.           3        may
  606.           4        1992
  607.           <EOF>
  608.           
  609.           % gcal -i -b 3 @file -s 3 1994
  610.           
  611.           ==> gcal -i -b 3 -j -Cw may 1992
  612. File: gcal-us.info,  Node: Actual date modifier,  Next: Commands,  Prev: Response file,  Up: Command line arguments
  613. Actual date modifier
  614. --------------------
  615.   It is allowed to use that date instead of the actual (system) date,
  616. which is defined by the `%DATE' option.  This means that fixed date
  617. warning messages can be created for *any* year and are like the warning
  618. messages of the actual year.
  619. The date must be denoted in one of these formats:
  620.    * `YYYY[MM[DD|WWW[N]]]'
  621.    * `YYYY*d|wN[WWW]'
  622.    * `YYYY@e|DVAR[[+|-]N[WWW]]'
  623.    * `MONTH NAME[DD]'
  624.    * `WEEKDAY NAME[N]'
  625.    * DD
  626. Some examples to this:
  627.      *Please note:*
  628.      Following examples assume the current date is Wednesday, the 17'th
  629.      February 1993 (19930217)!
  630. The `YYYY[MM][DD|WWW[N]]]' format:
  631.         * `gcal %1994' (== YYYY)
  632.           The actual date is set to the date 17'th February 1994
  633.           => 19940217.
  634.         * `gcal %1994Mar'
  635.         * `gcal %19943'
  636.         * `gcal %199403' (== YYYYMM)
  637.           The actual date is set to the date 17'th March 1994
  638.           => 19940317.
  639.         * `gcal %1994Mar3'
  640.         * `gcal %1994033'
  641.         * `gcal %19940303' (== YYYYMMDD)
  642.           The actual date is set to the date 3'rd March 1994
  643.           => 19940303.
  644.         * `gcal %1994Marth'
  645.         * `gcal %199403th' (== YYYYMMWWW)
  646.           The actual date is set to the date 4'th March 1994
  647.           => 19940304.
  648.         * `gcal %1994MarWed3'
  649.         * `gcal %199403wed3' (== YYYYMMWWWN)
  650.           The actual date is set to the date 3'rd Wednesday in March
  651.           1994 (N == `1...5|9') => 19940316.
  652.         * `gcal %0'
  653.         * `gcal %00'
  654.         * `gcal %000'
  655.         * `gcal %0000' (== YYYY)
  656.           The actual date remains unchanged => 19930217.
  657.         * `gcal %0000Mar'
  658.         * `gcal %00003'
  659.         * `gcal %000003' (== YYYYMM)
  660.           The actual date is set to the date 17'th March 1993
  661.           => 19930317.
  662.         * `gcal %0000Mar3'
  663.         * `gcal %0000033'
  664.         * `gcal %00000303' (== YYYYMMDD)
  665.           The actual date is set to the date 3'rd March 1993
  666.           => 19930303.
  667.         * `gcal %0000MarThu'
  668.         * `gcal %000003thu' (== YYYYMMWWW)
  669.           The actual date is set to the date 4'th March 1993
  670.           => 19930304.
  671.         * `gcal %0000MarWed3'
  672.         * `gcal %000003wed3' (== YYYYMMWWWN)
  673.           The actual date is set to the date 3'rd Wednesday in March
  674.           1993 (N == `1...5|9') => 19930317.
  675. The `YYYY*d|wN[WWW]' format:
  676.         * `gcal %1994*d10' (== `YYYY*dN')
  677.           The actual date is set to the date 10'th absolute day in 1994
  678.           (N == `1...365|366|999') => 19940110.
  679.         * `gcal %1994*d10sun' (== `YYYY*dNWWW')
  680.           The actual date is set to the date 10'th Sunday in 1994
  681.           (N == `1...51|52|53|99') => 19940306.
  682.         * `gcal %0*d10' (== `YYYY*dN')
  683.           The actual date is set to the date 10'th absolute day in 1993
  684.           => 19930110.
  685.         * `gcal %0*d10sun' (== `YYYY*dNWWW')
  686.           The actual date is set to the date 10'th Sunday in 1993
  687.           => 19930307.
  688.         * `gcal %1994*w10' (== `YYYY*wN')
  689.           The actual date is set to the date Monday of the 10'th week
  690.           in 1994 (N == `0|1...52|53|99') => 19940307.
  691.         * `gcal %1994*w10sun' (== `YYYY*wNWWW')
  692.           The actual date is set to the date Sunday of the 10'th week
  693.           in 1994 => 19940313.
  694.         * `gcal %0*w10' (== `YYYY*wN')
  695.           The actual date is set to the date Monday of the 10'th week
  696.           in 1993 => 19930308.
  697.         * `gcal %0*w10sun' (== `YYYY*wNWWW')
  698.           The actual date is set to the date Sunday of the 10'th week
  699.           in 1993 => 19930314.
  700. The `YYYY@e|DVAR[[+|-]N[WWW]]' format:
  701.         * `gcal %1994@e' (== `YYYY@e')
  702.           The actual date is set to the date Easter Sunday 1994
  703.           => 19940403.
  704.         * `gcal %1994@e10'
  705.         * `gcal %1994@e+10' (== `YYYY@e[+]N')
  706.           The actual date is set to the date 10 days after Easter
  707.           Sunday 1994 => 19940413.
  708.         * `gcal %1994@e-10' (== `YYYY@e-N')
  709.           The actual date is set to the date 10 days before Easter
  710.           Sunday 1994 => 19940324.
  711.         * `gcal %0@e'
  712.         * `gcal %00@e'
  713.         * `gcal %000@e'
  714.         * `gcal %0000@e' (== `YYYY@e')
  715.           The actual date is set to the date Easter Sunday 1993
  716.           => 19930411.
  717.         * `gcal %0@e10'
  718.         * `gcal %0@e+10' (== `YYYY@e[|]N')
  719.           The actual date is set to the date 10 days after Easter
  720.           Sunday 1993 => 19930421.
  721.         * `gcal %0@e-10' (== `YYYY@e-N')
  722.           The actual date is set to the date 10 days before Easter
  723.           Sunday 1993 => 19930401.
  724.         * `gcal %1994@e3Wed'
  725.         * `gcal %1994@e+3Wed' (== `YYYY@e[+]NWWW')
  726.           The actual date is set to the date 3'rd Wednesday after
  727.           Easter Sunday 1994 => 19940420.
  728.         * `gcal %1994@e-3wed' (== `YYYY@e-NWWW')
  729.           The actual date is set to the date 3'rd Wednesday before
  730.           Easter Sunday 1994 => 19940316.
  731.         * `gcal %0@e3wed'
  732.         * `gcal %0@e+3wed' (== `YYYY@e[+]NWWW')
  733.           The actual date is set to the date 3'rd Wednesday after
  734.           Easter Sunday 1993 => 19930428.
  735.         * `gcal %0@e-3we' (== `YYYY@e-NWWW')
  736.           The actual date is set to the date 3'rd Wednesday before
  737.           Easter Sunday 1993 => 19930324.
  738.         * `gcal -v a=0303 %1994@a' (== `YYYY@DVAR')
  739.           The actual date is set to the date 3'rd March 1994
  740.           => 19940303.
  741.         * `gcal -v a=0303 %1994@a10'
  742.         * `gcal -v a=0303 %1994@a+10' (== `YYYY@DVAR[+]N')
  743.           The actual date is set to the date 10 days after 3'rd March
  744.           1994 => 19940313.
  745.         * `gcal -v a=0303 %1994@a-10' (== `YYYY@DVAR-N')
  746.           The actual date is set to the date 10 days before 3'rd March
  747.           1994 => 19940221.
  748.         * `gcal -v a=0303 %0@a' (== `YYYY@DVAR')
  749.           The actual date is set to the date 3'rd March 1993
  750.           => 19930303.
  751.         * `gcal -v a=0303 %0@a10'
  752.         * `gcal -v a=0303 %0@a+10' (== `YYYY@DVAR[+]N')
  753.           The actual date is set to the date 10 days after 3'rd March
  754.           1993 => 19930313.
  755.         * `gcal -v a=0303 %0@a-10' (== `YYYY@DVAR-N')
  756.           The actual date is set to the date 10 days before 3'rd March
  757.           1993 => 19930221.
  758.         * `gcal -v a=0303 %1994@a3wed'
  759.         * `gcal -v a=0303 %1994@a+3wed' (== `YYYY@DVAR[+]NWWW')
  760.           The actual date is set to the date 3'rd Wednesday after 3'rd
  761.           March 1994 => 19940323.
  762.         * `gcal -v a=0303 %1994@a-3wed' (== `YYYY@DVAR-NWWW')
  763.           The actual date is set to the date 3'rd Wednesday before 3'rd
  764.           March 1994 => 19940216.
  765.         * `gcal -v a=0303 %0@a3wed'
  766.         * `gcal -v a=0303 %0@a+3wed' (== `YYYY@DVAR[+]NWWW')
  767.           The actual date is set to the date 3'rd Wednesday after 3'rd
  768.           March 1993 => 19930324.
  769.         * `gcal -v a=0303 %0@a-3wed' (== `YYYY@DVAR-NWWW')
  770.           The actual date is set to the date 3'rd Wednesday before 3'rd
  771.           March 1993 => 19930210.
  772. The `MONTH NAME[DD]' format:
  773.         * `gcal %April' (== MONTH NAME)
  774.           The actual date is set to the date 17'th April 1993
  775.           => 19930417.
  776.         * `gcal %april3'
  777.         * `gcal %april03' (== MONTH NAME DD)
  778.           The actual date is set to the date 3'rd April 1993
  779.           => 19930403.
  780. The `WEEKDAY NAME[N]' format:
  781.         * `gcal %Friday' (== WEEKDAY NAME)
  782.           The actual date is set to the date Friday of current week in
  783.           February 1993 => 19930219.
  784.         * `gcal %Friday2'
  785.         * `gcal %Friday02' (== WEEKDAY NAME N)
  786.           The actual date is set to the date 2'nd Friday in February
  787.           1993 (N == `1...5|9') => 19930212.
  788. The DD format:
  789.         * `gcal %3'
  790.         * `gcal %03' (== DD)
  791.           The actual date is set to the date 3'rd February 1993
  792.           => 19930203.
  793. File: gcal-us.info,  Node: Commands,  Prev: Actual date modifier,  Up: Command line arguments
  794. Commands
  795. --------
  796.   The commands control the periods Gcal respects.  They can be
  797. partitioned into four major classes, namely "single" commands, special
  798. "3-Month mode" commands, "lists" of commands and "ranges" of commands.
  799. Single commands and special 3-Month mode commands only produce *one*
  800. calendar sheet, command lists or command ranges produce *more than one*
  801. calendar sheet per run.  If a command list is given, Gcal works
  802. sequentially on each single command given in the list, one by one.  A
  803. command range is expanded first by Gcal and after expansion is done,
  804. Gcal works sequentially on each single command produced during the
  805. internal expansion step.
  806.   For understanding the notation used in the text below, MM is either a
  807. number, a month name or one of the special 3-Month mode commands `.',
  808. `..', `.+' and `.-'.  No month / year lists or ranges can be created in
  809. case a special 3-Month mode command is given.
  810.   The range of MM is valid from 1 to 12 or valid from January to
  811. December (both notations may be mixed).  Month names may be abbreviated
  812. if done unambiguously.  YYYY is a number.  The range of YYYY is valid
  813. from 1 to 9999.  A range (MM-MM YYYY+YYYY ...) must consist of two
  814. elements.  A list (MM,...,MM YYYY;...;YYYY ...) must contain two
  815. elements minimum and may have up to twelve elements maximum.
  816. Here is a list of all command range, command list and other command
  817. separator characters:
  818.        1. The `-' character is the *month range* separator.
  819.        2. The `,' character is the *month list* separator.
  820.        3. The `+' character is the *year range* separator.
  821.        4. The `;' character is the *year list* separator.
  822.        5. The `/' character is the *month of year* separator.
  823.        6. The `:' character is the *fiscal year* separator.
  824. * Menu:
  825. * Single commands::        How to use a Single command.
  826. * 3-Month mode commands::  How to use a 3-Month mode command.
  827. * Command lists::          How to use a List of commands.
  828. * Command ranges::         How to use a Range of commands.
  829. File: gcal-us.info,  Node: Single commands,  Next: 3-Month mode commands,  Prev: Commands,  Up: Commands
  830. Single commands
  831. ...............
  832. `NONE'
  833.      Current month of current year, called "single month mode" in
  834.      future.
  835. `MONTH NAME'
  836.      Selected month of current year, e.g.:
  837.           gcal may
  838.           gcal OCTOBER
  839.           gcal ja
  840. `YYYY'
  841.      Selected year, called "single year mode" in future, e.g.:
  842.           gcal 1992
  843. `MM YYYY'
  844. `MM/YYYY'
  845.      Single month of selected year, e.g.:
  846.           gcal 9 1992
  847.           gcal 9/1992
  848.           gcal Nov 1777
  849.           gcal Nov/1777
  850.      Single fiscal year, starting at *actual month* of *actual year*
  851.      and ending at month *actual month*-1 of *actual year*+1, called
  852.      "implicit fiscal year" in future, e.g.:
  853.           gcal :
  854. `MM:'
  855.      Single fiscal year, starting at month MM of *actual year* and
  856.      ending at month MM-1 of *actual year*+1, called "explicit fiscal
  857.      year" in future, e.g.:
  858.           gcal 6:
  859.           gcal feb:
  860.           gcal NOVEMBER:
  861. `:YYYY'
  862.      Single fiscal year, starting at *actual month* of year YYYY and
  863.      ending at month *actual month*-1 of year YYYY+1, called "explicit
  864.      fiscal year" too in future, e.g.:
  865.           gcal :1999
  866. `MM:YYYY'
  867.      Single fiscal year, starting at month MM of year YYYY and ending
  868.      at month MM-1 of year YYYY+1, called "explicit fiscal year" too in
  869.      future, e.g.:
  870.           gcal 7:1999
  871.           gcal oct:1992
  872.           gcal February:1777
  873. File: gcal-us.info,  Node: 3-Month mode commands,  Next: Command lists,  Prev: Single commands,  Up: Commands
  874. 3-Month mode commands
  875. .....................
  876.      Previous, actual and next month of current year, e.g.:
  877.           gcal .
  878. `. YYYY'
  879.      Previous, actual and next month of selected year, e.g.:
  880.           gcal . 1992
  881.      Actual quarter of current year, e.g.:
  882.           gcal ..
  883. `.. YYYY'
  884.      Actual quarter of selected year, e.g.:
  885.           gcal .. 1992
  886.      Actual and next two month of current year, e.g.:
  887.           gcal .+
  888. `.+ YYYY'
  889.      Actual and next two month of selected year, e.g.:
  890.           gcal .+ 1992
  891.      Actual and previous two month of current year, e.g.:
  892.           gcal .-
  893. `.- YYYY'
  894.      Actual and previous two month of selected year, e.g.:
  895.           gcal .- 1992
  896. File: gcal-us.info,  Node: Command lists,  Next: Command ranges,  Prev: 3-Month mode commands,  Up: Commands
  897. Command lists
  898. .............
  899. `MM,...,MM'
  900.      List of specified months in current year, e.g.:
  901.           gcal 1,5,12
  902.           gcal 3,1,5,3
  903.           gcal june,9,jan
  904. `MM/YYYY,...,MM/YYYY'
  905.      List of months in specified year, e.g.:
  906.           gcal 1/1992,5,12/2001
  907.           gcal june/1991,9/1801,jan
  908. `MM,...,MM YYYY'
  909.      List of specified months of selected year, e.g.:
  910.           gcal 3,7 1999
  911.           gcal 1,dec,july 1777
  912. `YYYY;...;YYYY'
  913.      List of specified years, e.g.:
  914.           gcal 1992;1777;1899
  915. `MM:YYYY;...;MM:YYYY'
  916.      List of specified fiscal years, e.g.:
  917.           gcal 7:1999;8:1992;April:3
  918. *Other valid lists:*
  919. `MM,MM/YYYY,...'
  920.      Mixed list of months consisting of: `MM MM/YYYY'
  921.           gcal 6,8,3/1999,feb/3,january
  922. `MM:;MM:YYYY;...'
  923.      Mixed list of fiscal years of given / actual year consisting of:
  924.      `MM: :YYYY MM:YYYY YYYY'
  925.           gcal 3:;1994;february:1999;:1777;JAN:
  926. `MM:;MM:;...'
  927.      List of fiscal years of actual year consisting of: `MM:'
  928.           gcal 3:;august:;DEC:
  929. File: gcal-us.info,  Node: Command ranges,  Prev: Command lists,  Up: Commands
  930. Command ranges
  931. ..............
  932. `MM-MM'
  933.      Range of current months, e.g.:
  934.           gcal 3-7
  935.           gcal 11-8
  936.           gcal m-dec
  937.           gcal 12-aug
  938. `MM/YYYY-MM/YYYY'
  939.      Range of months of year, e.g.:
  940.           gcal 3/1991-july/1992
  941.           gcal dec/1994-3
  942.           gcal sep-dec/2000
  943. `MM-MM YYYY'
  944.      Range of specified months of selected year, e.g.:
  945.           gcal 3-7 1999
  946.           gcal nov-3 1777
  947.           gcal aug-dec 1992
  948. `YYYY+YYYY'
  949.      Range of specified years, e.g.:
  950.           gcal 1992+1994
  951. `MM:YYYY+MM:YYYY'
  952.      Range of specified fiscal years, e.g.:
  953.           gcal 7:1999+8:1992
  954.           gcal aug:1992+july:1999
  955. File: gcal-us.info,  Node: The GCAL environment variable,  Prev: Command line arguments,  Up: Invoking Gcal
  956. The `GCAL' environment variable
  957. ===============================
  958.   The environment variable `GCAL' can hold a set of default options for
  959. Gcal (*note GCAL: Environment variables.).  These options are
  960. interpreted first at program start-up and some can be overwritten by
  961. explicit command line arguments or values which are found in a response
  962. file option `@FILE'.  *Note Command line arguments::, and *Note
  963. Response file::.
  964. For example:
  965.    * for *sh*:
  966.           GCAL="-i -b 3"; export GCAL
  967.    * for *csh*:
  968.           setenv GCAL "-i -b 3"
  969.    * for *MSDOS*:
  970.           set GCAL=-i -b 3
  971.   On Vax/VMS, the name of the environment variable is `GCAL_OPT', to
  972. avoid a conflict with the symbol `GCAL' set for invocation of the
  973. program.
  974. For example:
  975.    * for *VMS*:
  976.           define GCAL_OPT "-i -b 3"
  977. File: gcal-us.info,  Node: Eternal holidays,  Next: Fixed date warnings,  Prev: Invoking Gcal,  Up: Top
  978. Eternal holidays
  979. ****************
  980. The *eternal holiday list* is created only for dates after A.D.463.
  981. It can be displayed in different ways:
  982.   In case you start Gcal without an explicit (fiscal) date and the
  983. *eternal holiday list* argument (*note `--holiday-list[=long|short]':
  984. Calendar options.), e.g.:
  985.      gcal --holiday-list
  986.      gcal -n
  987.      gcal -n :
  988. Gcal displays all holidays of the eternal holiday list, that refer to
  989. the actual / fiscal year without a leading calendar.
  990.   In case you start Gcal with the *eternal holiday list* argument and a
  991. month (plus an additional year), e.g.:
  992.      gcal --holiday-list july
  993.      gcal -n july
  994.      gcal -n 7 1993
  995.      gcal -n 7/1993
  996. Gcal displays a month calendar of the specified month (of year) and
  997. trailing those holidays of the eternal holiday list, that refer to the
  998. given month (of given year).
  999.   In case you start Gcal with the *eternal holiday list* argument and a
  1000. simple year or an explicit fiscal year, e.g.:
  1001.      gcal --holiday-list 1993
  1002.      gcal -n 1993
  1003.      gcal -n july:
  1004.      gcal -n :1993
  1005.      gcal -n 7:1993
  1006. Gcal displays a year calendar of the specified year or fiscal year and
  1007. trailing all holidays of the eternal holiday list, that refer to the
  1008. given year or fiscal year.
  1009.   In case you start Gcal with the *eternal holiday list* argument and a
  1010. special 3-Month mode command (*note `..': Commands.), e.g.:
  1011.      gcal --holiday-list .
  1012.      gcal -n .
  1013.      gcal -n ..
  1014.      gcal -n .+
  1015.      gcal -n .-
  1016. Gcal displays the according three months using a fixed year calendar
  1017. style and trailing all holidays of the eternal holiday list, that refer
  1018. to the these months.
  1019.